Skip to content

[Cloudflare for SaaS, SSL] Clarify hostname readiness#30557

Merged
irvinebroque merged 2 commits into
productionfrom
improve-ssl-for-saas-docs
May 7, 2026
Merged

[Cloudflare for SaaS, SSL] Clarify hostname readiness#30557
irvinebroque merged 2 commits into
productionfrom
improve-ssl-for-saas-docs

Conversation

@irvinebroque

Copy link
Copy Markdown
Contributor

Summary

Updates the Cloudflare for SaaS API docs and SSL certificate status reference to clarify how to interpret the Custom Hostname Details response. The PR explains that the top-level status tracks hostname activation, nested ssl.status tracks certificate issuance and deployment, and production HTTPS readiness requires both values to be active with customer DNS pointed to the SaaS target.

Also notes that a successful TLS handshake alone is not the readiness source of truth because Cloudflare may present another matching certificate, and that non-wildcard custom hostnames can complete automatic HTTP certificate validation even when TXT validation was selected.

Documentation checklist

@github-actions

github-actions Bot commented May 4, 2026

Copy link
Copy Markdown
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/cloudflare-for-platforms/ @irvinebroque, @dinasaur404, @cloudflare/pcx-technical-writing, @cloudflare/product-owners
/src/content/docs/ssl/ @RebeccaTamachiro, @cloudflare/pcx-technical-writing, @cloudflare/product-owners
* @cloudflare/pcx-technical-writing, @cloudflare/product-owners

@github-actions

github-actions Bot commented May 4, 2026

Copy link
Copy Markdown
Contributor

Preview URL: https://1780bbad.preview.developers.cloudflare.com
Preview Branch URL: https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/start/common-api-calls/ https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/start/common-api-calls/
https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/http/ https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/http/
https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/start/getting-started/ https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/start/getting-started/
https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/domain-support/hostname-validation/ https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/domain-support/hostname-validation/
https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/txt/ https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/txt/
https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/domain-support/hostname-validation/validation-status/ https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/domain-support/hostname-validation/validation-status/
https://developers.cloudflare.com/ssl/reference/certificate-statuses/ https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com/ssl/reference/certificate-statuses/
https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/ https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/

@irvinebroque irvinebroque marked this pull request as ready for review May 4, 2026 16:56
@irvinebroque irvinebroque requested a review from a team May 4, 2026 16:56
@irvinebroque irvinebroque requested a review from dinasaur404 as a code owner May 4, 2026 16:56
@github-actions

github-actions Bot commented May 4, 2026

Copy link
Copy Markdown
Contributor

This PR requires additional review attention because it affects the following areas:

Partials

This PR updates partial files, which are pieces of content used across multiple files in our Render component.

@irvinebroque irvinebroque enabled auto-merge (squash) May 4, 2026 19:46
@irvinebroque irvinebroque merged commit 68a42e1 into production May 7, 2026
13 checks passed
@irvinebroque irvinebroque deleted the improve-ssl-for-saas-docs branch May 7, 2026 16:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants